home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / debug.doc < prev    next >
Text File  |  1995-03-31  |  3KB  |  68 lines
  1.  
  2.                         DEBUG - system rpl debugger 
  3.                         ~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
  4.  
  5. SDBG    ( ob --> ) 
  6.         Starts system rpl debugger with the program on stk1 
  7.         (Or ID/LAM/ROMPTR) 
  8. ->SST 
  9.         Single steps one instruction. 
  10. ->IN 
  11.         Single steps one instruction. Secondaries/romptrs/ids/lams are 
  12.         stepped into if they contain a program. 
  13. SNXT 
  14.         Displays next commands. 
  15.         Second press displays return stack contents. 
  16. SST-> 
  17.         Single steps in slow-mo. Second press starts fast-mo in which stack 
  18.         display is not updated. 
  19. IN-> 
  20.         Similar to above with ->IN. 
  21. DHALT 
  22.         Similar to HALT, but exits similarly to other debugger commands. 
  23.         (4/5/7 is executed if it is found to exist) 
  24. DBRK    ( ob --> ) 
  25.         Sets breakpoint command. SST-> and IN-> are stopped if ob was 
  26.         executed. 
  27. DEXEC   ( ob --> ) 
  28.         Executes stk1 on top of debugged program. 
  29.         Execution is done by adding COLA DHALT commands to stk1 and evaluating 
  30.         it on top of the debugged body that is on the return stack. 
  31.  
  32.         With this you can make your own debugger commands but be careful not 
  33.         to use return stack levels below the program, you could mix up the 
  34.         original UI that is returned to after finished the debugger. 
  35.  
  36.         Example commands: 
  37.  
  38.         Skip next command:                      :: ' :: RSKIP ; DEXEC ; 
  39.         Drop current stream:                    :: ' RDROP DEXEC ; 
  40.  
  41.         (The difference is due to the fact that RSKIP already is a secondary.) 
  42.  
  43.         Drop return stack:                      :: ' :: RSWAP RDROP ; DEXEC ; 
  44.         Recall current stream:                  :: ' :: R@ ; DEXEC ; 
  45.  
  46.         Setting new PC: (hxs --> ) 
  47.                         :: CK1&Dispatch ELEVEN 
  48.                                 :: HXS># #5- PTR C612 (RclData) 
  49.                                    ' :: RDROP >R ; 
  50.                                    DEXEC 
  51.                                 ; 
  52.                         ; 
  53.  
  54. LOOPS 
  55.         Displays data in loop environments. Use up/down arrows to scroll 
  56.         through the environments. 
  57. LAMS 
  58.         Not implemented yet. 
  59. IN? 
  60.         Toggles debugging into secondaries (to avoid unnecessary debugging of 
  61.         subroutines when using IN). Does not affect IN for IDs/LAMs/ROMPTRs . 
  62.  
  63. Notes about HP commands: 
  64.  
  65.         CONT works normally. 
  66.         KILL does not destroy error traps nor loop environments. :( 
  67.         To use HALT (or DHALT) start SDBG first, then press CONT. 
  68.